<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt-br" lang="pt-br">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Classe Idioma : Guia do Usuário CodeIgniter</title>

<style type='text/css' media='all'>@import url('../userguide.css');</style>
<link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />

<script type="text/javascript" src="../nav/nav.js"></script>
<script type="text/javascript" src="../nav/prototype.lite.js"></script>
<script type="text/javascript" src="../nav/moo.fx.js"></script>
<script type="text/javascript" src="../nav/user_guide_menu.js"></script>

<meta http-equiv="expires" content="-1" />
<meta http-equiv="pragma" content="no-cache" />
<meta name="robots" content="all" />
<meta name="author" content="ExpressionEngine Dev Team" />
<meta name="description" content="Guia do Usuário do CodeIgniter" />

</head>
<body>

<!-- START NAVIGATION -->
<div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="Alternar Tabela de Conteúdos" alt="Alternar Tabela de Conteúdos" /></a></div>
<div id="masthead">
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td><h1>Guia de Usuário CodeIgniter Versão 2.0.0</h1></td>
<td id="breadcrumb_right"><a href="../toc.html">Tabela de Conteúdos</a></td>
</tr>
</table>
</div>
<!-- END NAVIGATION -->


<!-- START BREADCRUMB -->
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td id="breadcrumb">
<a href="http://codeigniter.com.br/">Página Inicial</a> › 
<a href="../index.html">Guia de Usuário CodeIgniter</a> › Classe Idioma
</td>
<td id="searchbox"><form method="get" action="http://www.google.com.br/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.com.br/manual/" />Busca <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" /> <input type="submit" class="submit" name="sa" value="Ok" /></form></td>
</tr>
</table>
<!-- END BREADCRUMB -->

<br clear="all" />


<!-- START CONTENT -->
<div id="content">


<h1>Classe Idioma</h1>

<p>A Classe idioma fornece funções para recuperar arquivos de idioma e as linhas de texto para fins de internacionalização.</p>

<p>Em sua pasta de sistema do CodeIgniter você encontrará uma chamada <dfn>language</dfn> que contém conjuntos de arquivos de idioma. Você pode criar
seu próprio arquivo de idioma se precisar para a exibição de erro e outras mensagens em outros idiomas.</p>

<p>Os arquivos de idiomas são normalmente armazenados no diretório <dfn> system/idioma </dfn>. Como alternativa, você pode criar uma pasta chamada <kbd>language</kbd> dentro
da sua pasta <kbd>aplication</kbd> e armazená-los lá. O CodeIgniter irá procurar primeiro em seu diretório <dfn>application/language</dfn>. 
Se o diretório não existe ou o idioma especificado não for localizado lá, o CI irá procurar então em sua pasta global
<dfn>system/language</dfn>.</p>

<p class="important"><strong>Nota:</strong>&nbsp; Cada idioma deve ser armazenado em uma pasta própria. Por examplo, os arquivos English estão localizados em:
<dfn>system/language/english</dfn></p>



<h2>Criando Arquivos de Idioma</h2>

<p>Os arquivos de idiomas devem terminar o nome do arquivo com <kbd>_lang.php</kbd> como uma extensão do arquivo. Por exemplo, digamos que você queira criar um arquivo
contendo mensagens de erro. Você poderá colocar o nome de: <kbd>error_lang.php</kbd></p>

<p>Dentro do arquivo que você vai atribuir a cada linha de texto para um array chamado <var>$lang</var> com este protótipo:</p>

<code>$lang['language_key'] = "A mensagem atual para ser mostrada";</code>

<p><strong>Nota:</strong> É uma boa prática a usar um prefixo comum para todas as mensagens de um determinado arquivo para evitar conflitos com
itens nomeados similarmente em outros arquivos. Por examplo, se você esta criando mensagens de erro você pode colocar prefixo com <var>error_</var></p>

<code>$lang['<var>error</var>_email_missing'] = "Você deve enviar um e-mail";<br />
$lang['<var>error</var>_url_missing'] = "Você deve enviar uma URL";<br />
$lang['<var>error</var>_username_missing'] = "Você deve enviar um nome de usuário";</code>


<h2>Carregando um Arquivo de Idioma</h2>

<p>A fim de buscar uma linha de um arquivo específico que você deve primeiro carregar o arquivo. Carregando um arquivo de idioma é feito com o seguinte código:</p>

<code>$this->lang->load('<samp>nome_do_arquivo</samp>', '<dfn>language</dfn>');</code>

<p>Onde <samp>nome_do_arquivo</samp> é o nome do arquivo que você deseja carregar (sem a extensão de arquivo), e <dfn>language</dfn>
é o idioma definido que o contenham (ou seja, english). Se o segundo parâmetro não for informado, o idioma padrão configurado no seu 
arquivo <kbd>application/config/config.php</kbd> será usado.</p>


<h2>Buscando uma Linha de Texto</h2>

<p>Depois que o arquivo de idioma desejado for carregado você pode acessar qualquer linha de texto usando este método:</p>

<code>$this->lang->line('<samp>language_key</samp>');</code>

<p>Onde <samp>language_key</samp> é a chave correspondente para a linha de você deseja mostrar.</p>

<p>Nota: Este método simplismente retorna uma linha. Ele não exibe para você.</p>

<h3>Usando linhas de idioma como rótulos de formulários</h3>

<p class="important">Este recurso foi depreciado a partir da biblioteca language e movida para <kbd>lang()</kbd> função do <a href="../helpers/language_helper.html">Assistente de Idioma</a>.</p>

<h2>Auto-carregamento de Idiomas</h2>
<p>se você achar que precisa de um idioma global em sua aplicação, pode dizer ao CodeIgniter <a href="../general/autoloader.html">auto-carregar</a> durante a inicialização do sistema. Isso é feito abrindo o arquivo application/config/autoload.php e adicionando o(s) idioma(s) ao array autoload.</p>
<p>&nbsp;</p>
</div>
<!-- END CONTENT -->


<div id="footer">
<p>
Tópico Anterior:&nbsp;&nbsp;<a href="loader.html">Classe Loader</a>
&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="#top">Topo da Página</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="../index.html">Guia de Usuário CodeIgniter</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
Próximo Assunto:&nbsp;&nbsp;<a href="output.html">Classe Output</a>
</p>
<p><a href="http://codeigniter.com.br">CodeIgniter</a> &nbsp;&middot;&nbsp; Copyright &#169; 2006 - 2011 &nbsp;&middot;&nbsp; <a href="http://ellislab.com/">EllisLab, Inc.</a></p>
</div>

</body>
</html>